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APPENDIX I - SYSTEM HANDLER REGISTRAR 

© Copyright 2003 Time Warner Cable, Inc. All rights reserved. 



import java.lang.*; 
import java. security.*; 



/** 

* Registration mechanism for trusted applications to set the error handler. 
*/ 

1 0 public class SysHandlerRegistrar 
{ 

public final static int ERROR_INFO_EVENT_HANDLER = 0x0; 

public final static int REBOOTEVENTHANDLER = 0x1 ; 

public final static int RESOURCE DEPLETION EVENT HANDLER = 0x2; 

15 

private static SysHandlerRegistrar theSHR = null; 
private static lEventHandler theErrorlnfoEventHandler = null; 
private static lEventHandler theRebootEventHandler = null; 
private static lEventHandler theResourceDepletionHandler = null; 

/** 

* Zero argument constructor is protected so an application cannot create it. 
*/ 

protected SysHandlerRegistrar() 
25 { 

} 

/** 

* Get the singleton instance of the system handler registrar. 

30 

* @param type - ERRORINFOEVENTHANDLER, REBOOT EVENT HANDLER, or 

* RESOURCE DEPLETION HANDLER. 
* 

* @return The system handler registrar. 
35 */ 

public static SysHandlerRegistrar getlnstance() 

{ 

if(theSHR == null) 
theSHR = new SysHandlerRegistrarQ; 



return theSHR; 

} 



/** 

45 * Get the system system handler. 

* 

* @param type - ERRORINFOEVENTHANDLER, REBOOT_EVENT_HANDLER, or 

* RESOURCE DEPLETION HANDLER. 
* 

50 * @return Currently registered handler for the type specified. 

* @throws SysHandlerPermission if the application does not have permission 

* to get the handler. 
*/ 

55 public static lEventHandler getEventHandler(int type) throws SecurityException 
{ 

SysHandlerPermission ehp = new SysHandlerPermissionC'getEventHandler"); 
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// If the caller does not have permission the AccessController will throw a 
// SecurityException. 

//AccessController.checkPermission(ehp); to be uncommented 

5 

if(type = ERROR_rNFO_EVENT_HANDLER) 

return theErrorlnfoEventHandler; 
else 

if(type = REBOOTJVENTJiANDLER) 
1 0 return theRebootEventHandler; 

else 

return theResourceDepIetionHandler; 

} 

15 /** 

* Set the system event handler. 
* 

* @param type - ERROR_lNFO_EVENT_HANDLER, REBOOT_EVENT_HANDLER, or 

* RESOURCE_DEPLETION_HANDLER. 

20 

* @param seh - System event handler created by the registering application. 

* @throws EventHandlerPermission if the application does not have permission 

* to set the handler. 
25 */ 

public static void setEventHandler(int type, IEventHandler seh) throws SecurityException 

{ 

SysHandlerPermission ehp = new SysHandlerPermission("setEventHandler"); 

30 // If the caller does not have permission the AccessController will throw a 

// SecurityException. 

//AccessController.checkPermission(ehp); to be uncommented 

if(type == ERRORJNFO_EVENT_HANDLER) 
35 theErrorlnfoEventHandler = seh; 

else 

if(type == REBOOTEVENTHANDLER) 

theRebootEventHandler = seh; 
else 

40 theResourceDepIetionHandler = seh; 

} 

/** 

45 * Unset the system event handler, 

* 

* @param type - ERRORINFOEVENTHANDLER, REBOOT EVENT HANDLER, or 

* RESOURCEDEPLETIONHANDLER. 
* 

50 * @throws EventHandlerPermission if the application does not have permission 

* to unset the handler. 
*/ 

public static void unsetEventHandler(int type) throws SecurityException 
{ 

55 SysHandlerPermission ehp = new SysHandlerPermission("setEventHandler"); 

// If the caller does not have permission the AccessController will throw a 
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// SecurityException. 

//AccessController.checkPermission(ehp); to be uncommented 

ifl(type = ERRORJNFO_EVENT_HANDLER) 

theErrorlnfoEventHandler = null; 
else 

if(type = REBOOTEVENTHANDLER) 

theRebootEventHandler = null; 
else 

theResourceDepletionHandler = null; 
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